Move documentation to inline comments: GtkFileChooserWidget

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 69350ee8d99f7906cbf08ef48068a8315a14b14a..91c807ffa629fa1dc99f1f22b5265dd631150e98 100644 (file)
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -31,6 +31,7 @@ gtkeventbox.sgml
 gtkexpander.sgml
 gtkfeatures.sgml
 gtkfixed.sgml
+gtkfilechooserwidget.sgml
 gtkfilefilter.sgml
 gtkfontbutton.sgml
 gtkhbox.sgml

diff --git a/docs/reference/gtk/tmpl/gtkfilechooserwidget.sgml b/docs/reference/gtk/tmpl/gtkfilechooserwidget.sgml
deleted file mode 100644 (file)
index 434d709..0000000
--- a/docs/reference/gtk/tmpl/gtkfilechooserwidget.sgml
+++ /dev/null
@@ -1,57 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkFileChooserWidget
-
-<!-- ##### SECTION Short_Description ##### -->
-File chooser widget that can be embedded in other widgets
-
-<!-- ##### SECTION Long_Description ##### -->
-    <para>
-      #GtkFileChooserWidget is a widget suitable for selecting files.
-      It is the main building block of a #GtkFileChooserDialog.  Most
-      applications will only need to use the latter; you can use
-      #GtkFileChooserWidget as part of a larger window if you have
-      special needs.
-    </para>
-
-    <para>
-      Note that #GtkFileChooserWidget does not have any methods of its
-      own.  Instead, you should use the functions that work on a
-      #GtkFileChooser.
-    </para>
-
-<!-- ##### SECTION See_Also ##### -->
-    <para>
-      #GtkFileChooser, #GtkFileChooserDialog
-    </para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkFileChooserWidget ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION gtk_file_chooser_widget_new ##### -->
-<para>
-
-</para>
-
-@action: 
-@Returns: 
-
-
-
-
-<!--
-Local variables:
-mode: sgml
-sgml-parent-document: ("../gtk-docs.sgml" "book" "refentry")
-End:
--->
-
-

diff --git a/gtk/gtkfilechooserwidget.c b/gtk/gtkfilechooserwidget.c
index 567f77f152535cd941b3c59804ba8c330cb4f0f6..7969bff200923234d12e77efb216cc6f5a90c6d3 100644 (file)
--- a/gtk/gtkfilechooserwidget.c
+++ b/gtk/gtkfilechooserwidget.c
@@ -28,6 +28,25 @@
 #include "gtkfilechooserembed.h"
 #include "gtkintl.h"
 
+
+/**
+ * SECTION:gtkfilechooserwidget
+ * @Short_description: File chooser widget that can be embedded in other widgets
+ * @Title: GtkFileChooserWidget
+ * @See_also: #GtkFileChooser, #GtkFileChooserDialog
+ *
+ * #GtkFileChooserWidget is a widget suitable for selecting files.
+ * It is the main building block of a #GtkFileChooserDialog.  Most
+ * applications will only need to use the latter; you can use
+ * #GtkFileChooserWidget as part of a larger window if you have
+ * special needs.
+ *
+ * Note that #GtkFileChooserWidget does not have any methods of its
+ * own.  Instead, you should use the functions that work on a
+ * #GtkFileChooser.
+ */
+
+
 #define GTK_FILE_CHOOSER_WIDGET_GET_PRIVATE(o)  (GTK_FILE_CHOOSER_WIDGET (o)->priv)
 
 static void gtk_file_chooser_widget_finalize     (GObject                   *object);